home *** CD-ROM | disk | FTP | other *** search
/ Aminet 39 / Aminet 39 (2000)(Schatztruhe)[!][Oct 2000].iso / Aminet / mus / misc / DelfSF.readme < prev    next >
Text File  |  2000-09-02  |  5KB  |  118 lines
  1. Short:  Sndfile player for Delfina DSP
  2. Author: Smack/Infect! (Michael Henke)
  3. Type:   mus/misc
  4.  
  5. $VER: DelfSF 0.1 (Mon 10-Jul-2000)
  6.  
  7.  
  8.  #features
  9.    -reads audio files using sndfile.library
  10.     (supports various file formats and raw PCM files)
  11.  
  12.    -direct Delfina playback for best performance + quality
  13.  
  14.    -free software (full source code included, of course)
  15.  
  16.  
  17.  #requirements
  18.    -CPU 68020+
  19.    -AmigaOS V37+
  20.    -Delfina DSP board
  21.    -sndfile.library v1.21
  22.      you can find it in the latest port of LAME (3.85beta)
  23.      http://www.honeypot.net/audio/archives/LAMEbeta.lzx
  24.  
  25.    -developed on: A1200 (68030+882 @ 40MHz, 16MB Fast, Delfina1200 DSP)
  26.  
  27.  
  28.  #how to use it
  29.    DelfSF is a shell-only program. These options can be used:
  30.  
  31.    FILES            specify one or more filenames.
  32.                     if omitted a reqtools file requester appears.
  33.  
  34.    NOPLAY   / -n    don't play but just output some information.
  35.                     this works also without a Delfina board.
  36.  
  37.    NOTIMER  / -nt   don't output the position timer during playback.
  38.                     you should specify this option if you use DelfSF to play
  39.                     some background music while you're using other programs.
  40.                     (pulldown-menus, drag'n'drop etc. will block the timer
  41.                     output thus also delaying the file reader)
  42.  
  43.    VOLUME  / -vol <number>   (default: 100)
  44.                     set the playback volume (in per cent, range 0...200).
  45.                     warning: if the volume is boosted (101...200) there might
  46.                     be distortions due to output clipping.
  47.  
  48.    RATE     / -r  <number>   (default: 44100)
  49.    -raw-            set the playback rate in Hz (raw files only).
  50.  
  51.    BITS     / -b  <number>   (default: 16)
  52.    -raw-            set the number of bits per sample (raw files only).
  53.  
  54.    CHANNELS / -c  <number>   (default: 2)
  55.    -raw-            set the number of channels (raw files only).
  56.  
  57.    BYTESWAP / -bs   (default: false)
  58.    -raw-            set the sample format to 'little endian' (raw files only).
  59.                     try this if your 16bit (CDDA) files sound like static.
  60.  
  61.    note: raw files will only be played if at least one of the raw file options
  62.    (RATE, BITS, CHANNELS, BYTESWAP) is specified, in order to avoid accidental
  63.    playback of non-audio files which could be very noisy.
  64.  
  65.    During playback these keys can be used:
  66.  
  67.    Ctrl-F   fast forward
  68.    Ctrl-E   pause/continue
  69.    Ctrl-C   stop current file, start next file
  70.    Ctrl-D   quit program
  71.  
  72.  
  73.  #technical stuff
  74.    -The source code of DelfSF is split into two parts: the main part contains
  75.     all the generic stuff (file requester, sndfile.library calls, buffering)
  76.     while the Delfina-specific code is situated in a separate part.
  77.     This should make it fairly easy to write a player for other output devices
  78.     (e.g. Amiga native, sound boards, AHI), recycling the main part of DelfSF
  79.     and only replacing its Delfina part. Feel free to contact me if you have
  80.     any comments, suggestions or need some help concerning the code.
  81.  
  82.  
  83.  #author
  84.    mailto: smack@smack.de
  85.  
  86.    DelfSF - sndfile player for Delfina DSP
  87.    Copyright (C) 2000  Michael Henke
  88.  
  89.    This program is free software; you can redistribute it and/or modify
  90.    it under the terms of the GNU General Public License as published by
  91.    the Free Software Foundation; either version 2 of the License, or
  92.    (at your option) any later version.
  93.  
  94.    This program is distributed in the hope that it will be useful,
  95.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  96.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  97.    GNU General Public License for more details.
  98.  
  99.    You should have received a copy of the GNU General Public License
  100.    along with this program; if not, write to the Free Software
  101.    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  102.  
  103.  
  104. ============================= Archive contents =============================
  105.  
  106. Original  Packed Ratio    Date     Time    Name
  107. -------- ------- ----- --------- --------  -------------
  108.    18113    7000 61.3% 11-Jul-00 00:57:32 +COPYING
  109.    18404   11408 38.0% 11-Jul-00 00:57:32 +DelfSF
  110.     3878    1845 52.4% 11-Jul-00 00:57:32 +DelfSF.readme
  111.     4641    1790 61.4% 11-Jul-00 00:57:32 +delf.c
  112.     3313    1493 54.9% 11-Jul-00 00:57:32 +delf_PCM.a56
  113.    11534    3504 69.6% 11-Jul-00 00:57:32 +main.c
  114.      112      87 22.3% 11-Jul-00 00:57:32 +SCOPTIONS
  115.      202     106 47.5% 11-Jul-00 00:57:32 +smakefile
  116. -------- ------- ----- --------- --------
  117.    60197   27233 54.7% 11-Jul-100 18:49:06   8 files
  118.